What changed

• updated the core documentation to point readers to context-compiler-example-integrations for runnable enforcement-point and host integration examples
• clarified the distinct roles of core examples, demos, and the companion integrations repository
• extracted the detailed public API documentation into docs/api-reference.md
• streamlined the top-level README while preserving the quickstart, authority model, core concepts, and concise API guidance
• clarified that demo prompt reinjection is a dependency-light comparison baseline rather than the only production integration pattern
• reordered example and demo inventories numerically
• bumped the package version to 0.8.2 and updated uv.lock

Why

• improve project and companion-repository discoverability
• keep the core repository focused on authority semantics and engine behavior
• make the README easier to navigate and maintain
• provide a dedicated reference for the public Python API
• clarify where users should find core teaching examples, evaluation demos, and runnable application integrations
• publish the documentation improvements through the package release surfaces

Checklist

• pre-commit run (uv run pre-commit run --all-files)
• tests pass (uv run pytest)